home *** CD-ROM | disk | FTP | other *** search
/ Shareware Universe - The Gold Collection / Shareware Universe The Gold Collection.iso / business / 4dos / 4dos.go next >
Text File  |  1996-04-19  |  21KB  |  465 lines
  1.  
  2.                                   JP Software
  3.  
  4.                            4DOS Shareware README.DOC
  5.  
  6.                        Version 5.0 -- November 23, 1993
  7.  
  8.  
  9.    Copyright 1988 - 1993, JP Software Inc., All Rights Reserved.  Published
  10.    by JP Software Inc., P.O. Box 1470, E. Arlington, MA 02174 USA, (617)
  11.    646-3975.
  12.  
  13.  
  14.    Greetings, and thanks for trying 4DOS!
  15.  
  16.    This file contains a variety of information you should read before using
  17.    4DOS, including:
  18.  
  19.       * Changes in version 5.0          * Technical support
  20.       * Files included with 4DOS        * Bulletin board support
  21.       * Installation instructions       * Shareware and ASP policies
  22.       * Upgrading from 4DOS 4.x
  23.  
  24.    If you have tried a shareware copy of 4DOS and want to place an order,
  25.    or if you'd like to find out about our other products (including our
  26.    enhanced command processors for OS/2 and Windows NT:  4OS2 and 4DOS/NT),
  27.    see the product and ordering information in the file ORDERINF.DOC, or
  28.    call us at (800) 368-8777 (USA only, orders only please!) or (617) 646-
  29.    3975.  The order form is included separately in the file ORDER.FRM.
  30.  
  31.    For complete installation instructions, see page 4.  These instructions
  32.    cover installation procedures for both new users and those upgrading
  33.    from a previous version of 4DOS.  If you are upgrading a registered copy
  34.    of 4DOS and you have the version 4.01 or 4.02 BRAND program, you MUST
  35.    run BRAND5.EXE (included with this copy of 4DOS) to brand version 5.0. 
  36.    See the upgrade instructions for further details.
  37.  
  38.    The license agreement which governs your use of 4DOS is included
  39.    separately in the file LICENSE.DOC.  Please read it before ordering. 
  40.    The text is written in plain English, and clearly explains your rights
  41.    and responsibilities as a user of 4DOS.  For more information on the
  42.    shareware system under which you obtained this copy of 4DOS, see page 7.
  43.  
  44.    This file, like all 4DOS ASCII documentation files, is formatted at 58
  45.    lines per page, and contains form feeds and page footers.  It can be
  46.    viewed with a file viewer such as the 4DOS LIST command, or printed on
  47.    most PC printers using the command:
  48.  
  49.             copy readme.doc prn
  50.  
  51.    Printing it with a program that formats the pages is not likely to work
  52.    due to the formatting included in the file.
  53.                                                                (11/93-5.0A)
  54.  
  55.  
  56.  
  57.    4DOS 5.0  [11-23-93]           README.DOC                         page 1
  58.  
  59.  
  60.    Changes in Version 5.0
  61.  
  62.       Be sure to read the installation instructions in this file before
  63.       installing 4DOS 5.0!
  64.  
  65.       Version 5.0 is a major new release of 4DOS.  It coincides with
  66.       similar major releases of our other command processors:  4OS2 version
  67.       2.0 and 4DOS for Windows NT version 2.0.
  68.  
  69.       If you are a current 4DOS user, be sure to check over the list of
  70.       changes in this version, in the file UPDAT50.DOC, BEFORE you begin
  71.       using version 5.0!  The list below gives only a very small sample of
  72.       what's new in this version.  You may also want to look through
  73.       APPNOTES.DOC for any new application notes (look for a "5.0" in the
  74.       left margin).  If you're a new 4DOS user, you can skip UPDAT50.DOC.
  75.  
  76.       Major new features in this version include:
  77.  
  78.           "Ranges" allow you to select files for processing based on the
  79.           date and / or time a file was last modified, or the file's size.
  80.  
  81.           4DOS now supports global alias and history lists, so that you can
  82.           share aliases and / or the command history between multiple
  83.           shells.  
  84.  
  85.           .BTM files can now be compressed, to make it easier for PC and
  86.           network managers to distribute batch files whose contents cannot
  87.           readily be altered by the end user.
  88.  
  89.           The maximum file description length has been increased to 200
  90.           characters.
  91.  
  92.           You can select the colors used for command line input.
  93.  
  94.           There is a new popup directory history window which shows recent
  95.           directories you've used.
  96.  
  97.           There is a new filename completion window which allows you to pop
  98.           up a pick-list window of all the matching files, and insert a
  99.           selected filename into the command line.
  100.  
  101.           DO is a new loop control command for batch files.  
  102.  
  103.           KEYBD is a new command to toggle the state of the Caps Lock, Num
  104.           Lock, and Shift Lock keys.
  105.  
  106.           LIST has been completely rewritten and offers many new features.
  107.  
  108.           ON is a new error-handling command for batch files.
  109.  
  110.           There are dozens of new variables and variable functions for use
  111.           in batch files and aliases.
  112.  
  113.  
  114.  
  115.    4DOS 5.0  [11-23-93]           README.DOC                         page 2
  116.  
  117.  
  118.           The help system has been extensively revised to offer more
  119.           complete information and to make navigation easier.
  120.  
  121.  
  122.    Files Included with 4DOS 5.0
  123.  
  124.       Please note that the way your copy of 4DOS is "packaged" will vary
  125.       depending on the distribution method (5.25" disk, 3.5" disk, or on-
  126.       line).  In general there will be two 5.25", 360K disks, or one 3.5"
  127.       720K disk.  On-line copies will be in two .ZIP files, typically named
  128.       4DOS5A.ZIP and 4DOS5B.ZIP, or 4DOS50A.ZIP and 4DOS50B.ZIP.
  129.  
  130.       In addition, you may choose to download the 4DOS, 4OS2, and 4DOS/NT
  131.       Reference Manual (the file is named REFMAN.DOC, and is typically
  132.       stored in the file JP4REF.ZIP).  This is a large file and much of the
  133.       same information is available in the online help system, but we do
  134.       make the ASCII version of the manual available for those who wish to
  135.       download it.
  136.  
  137.       ZIP files distributed by JP Software will display the message
  138.       "Authentic files Verified!   # VHJ325   JP Software Inc." when they
  139.       are unzipped.  If you do not see this message, the ZIP file you are
  140.       using has been modified.  This does not necessarily indicate a
  141.       problem (for example, some BBS sysops "brand" 4DOS with their BBS
  142.       name using software from us; 4DOS ZIP files on these BBSes will not
  143.       show the JP Software verification message).  However it does alert
  144.       you to the fact that the file has been changed since it was created
  145.       by JP Software.
  146.  
  147.       The following files are included with this version of 4DOS:
  148.  
  149.           4DOS.COM            4DOS program file
  150.           4DOS.DOC            ASCII copy of the 4DOS Introduction and
  151.                               Installation Guide
  152.           4DOS.HLP            4DOS help text
  153.           4DOS.ICO            Icon file for 4DOS under Windows 3.x
  154.           4DOSM.ICO           Same as 4DOS.ICO but for monochrome systems
  155.           4DOSOS2A.ICO        Icon file for 4DOS under OS/2 2.x
  156.           4DOSOS2B.ICO        Second icon file for 4DOS under OS/2 2.x
  157.           4DOS.PIF            PIF file for running 4DOS under Windows 3.x
  158.           4HELP.EXE           4DOS help program
  159.           ALIASES             Sample aliases
  160.           APPNOTES.DOC        Information on using 4DOS with other products
  161.           BATCOMP.EXE         Batch file compression utility
  162.           BRAND5.EXE          BRAND program fix for those upgrading to
  163.                               version 5.0 from 4.01 or 4.02 (see the
  164.                               upgrade instructions for details)
  165.           HELPCFG.EXE         Color configuration program for the 4DOS help
  166.                               system
  167.           KSTACK.COM          Memory-resident program used by the 4DOS
  168.                               KEYSTACK command
  169.           LICENSE.DOC         The 4DOS shareware license agreement
  170.  
  171.  
  172.  
  173.    4DOS 5.0  [11-23-93]           README.DOC                         page 3
  174.  
  175.  
  176.           ORDER.FRM           4DOS shareware and upgrade order forms 
  177.           ORDERINF.DOC        Ordering and product information
  178.           README.DOC          This file
  179.           REFMAN.DOC          4DOS, 4OS2, and 4DOS/NT combined reference
  180.                               manual (must be downloaded separately, see
  181.                               above)
  182.           SAMPLES.BTM         Sample 4DOS batch files (all samples are
  183.                               included in one file)
  184.           SUPPORT.BBS         Information on Channel 1, the independent BBS
  185.                               used for 4DOS support
  186.           SYSOP.DOC           4DOS information for BBS sysops
  187.           TOUR1.BTM           Batch file used for the 4DOS "tour" (see
  188.             and TOUR2.BTM       TOUR.DOC)
  189.           TOUR.DOC            The 4DOS Guided Tour documentation
  190.           UPDAT50.DOC         Information on changes in 4DOS 5.0
  191.           VENDOR.DOC          4DOS information for shareware disk vendors
  192.  
  193.  
  194.    Installation Instructions
  195.  
  196.       (These instructions do not cover diskette installation, because when
  197.       4DOS is installed from diskette this file is not visible until after
  198.       installation is complete.)
  199.  
  200.       Whether or not you presently have 4DOS installed, create a new
  201.       directory for 4DOS 5.0 (do not install it in the same directory as a
  202.       previous version of 4DOS).  Decompress your downloaded 4DOS 5.0 files
  203.       into this directory.  You can print the 4DOS Introduction and
  204.       Installation Guide, or any 4DOS documentation file (including this
  205.       one), by copying it to the printer with the COPY command.
  206.  
  207.       Please note that the 4DOS Introduction and Installation Guide is
  208.       about 80 pages long, and the Reference Manual is over 380 pages long! 
  209.       If you don't want to print these files they can be viewed on-screen
  210.       with a file viewer such as the 4DOS LIST command.  Most of what's in
  211.       the Reference Manual is also available in the 4DOS help system.
  212.  
  213.       For a guided tour of 4DOS features see the instructions in TOUR.DOC. 
  214.       To install 4DOS completely, follow the manual installation
  215.       instructions in Chapter 1 of 4DOS.DOC, disregarding the discussion of
  216.       extracting files from the diskettes.
  217.  
  218.       Be sure you have a bootable DOS floppy disk (as described at the
  219.       beginning of Chapter 2) before installing 4DOS on your system.  This
  220.       is not because 4DOS is likely to cause trouble.  It's because a
  221.       mistake in the system startup files (CONFIG.SYS and AUTOEXEC.BAT), or
  222.       a power failure or other disturbance during installation, could
  223.       prevent your system from booting properly.  While such problems are
  224.       rare, any time you modify CONFIG.SYS or AUTOEXEC.BAT you should have
  225.       a bootable floppy disk handy so you can recover if necessary.
  226.  
  227.  
  228.  
  229.  
  230.  
  231.    4DOS 5.0  [11-23-93]           README.DOC                         page 4
  232.  
  233.  
  234.    Upgrading from 4DOS Version 4.0, 4.01, or 4.02 to Version 5.0
  235.  
  236.       Be sure to go over the changes in version 5.0, in the file
  237.       UPDAT50.DOC, before you start using it.  4DOS 5.0 can be run in "test
  238.       drive" mode over previous versions of 4DOS, so you can test the new
  239.       version before fully installing it.  4DOS 5.0 should always be
  240.       installed in a different directory (or if you have a floppy-disk
  241.       system, on a different disk) than any earlier version of 4DOS.
  242.  
  243.           IMPORTANT NOTE:  If you purchased a registered copy of 4DOS 4.01
  244.           or 4.02 and have downloaded 4DOS to upgrade to version 5.0, you
  245.           MUST run the BRAND5 program, rather than your current BRAND
  246.           program, to install your name and serial number into the new
  247.           version.  If you do not, BRAND will not work on version 5.0. 
  248.           This is due to a very minor bug in BRAND.
  249.  
  250.           BRAND5 modifies BRAND.EXE to correct this bug, then runs BRAND
  251.           for you.  Therefore you should place BRAND5.EXE, your version
  252.           4.01 or 4.02 BRAND.EXE, and your new version 5 4DOS.COM file in
  253.           the same directory, and have your brand codes handy, before
  254.           running BRAND5.
  255.  
  256.           Once you have used BRAND5 successfully the first time, your
  257.           BRAND.EXE program will be patched and can then be used by itself,
  258.           without BRAND5.
  259.  
  260.           This fix is not necessary for the version 4.0 BRAND program.  If
  261.           you are unsure of which version of BRAND.EXE you have, go ahead
  262.           and run BRAND5 -- it is well-behaved, and won't modify your copy
  263.           of BRAND.EXE unless the modification is needed and can be
  264.           performed correctly.  If your copy of BRAND.EXE doesn't need to
  265.           be modified, or has already been modified, BRAND5 will leave it
  266.           alone, but will go ahead and run it for you to complete the
  267.           branding process.
  268.  
  269.           If you receive a "Brand installation error 6" when attempting to
  270.           brand version 5.0, you probably have not run BRAND5, or BRAND5
  271.           did not finish correctly.  If you receive ANY other branding
  272.           error the problem lies elsewhere (for example, your eligibility
  273.           for a downloadable major upgrade may have expired).
  274.  
  275.           If you have trouble with BRAND5, reinstall the original BRAND.EXE
  276.           program from your 4DOS 4.x distribution disk, then run BRAND5
  277.           again.  If you still have difficulty, contact JP Software for
  278.           technical assistance.
  279.  
  280.       To upgrade from 4DOS 4.0, 4.01, or 4.02 to version 5.0, make the
  281.       following changes in your system configuration:
  282.  
  283.           * Modify the SHELL= line in CONFIG.SYS to reflect the new
  284.             directory where 4DOS.COM is stored.  Make a similar
  285.  
  286.  
  287.  
  288.  
  289.    4DOS 5.0  [11-23-93]           README.DOC                         page 5
  290.  
  291.  
  292.             modification to any SET COMSPEC statements you have in
  293.             AUTOEXEC.BAT or other batch files.
  294.  
  295.           * Modify any line in AUTOEXEC.BAT which loads KSTACK.COM to
  296.             reflect the new directory where KSTACK.COM is stored.
  297.  
  298.           * If you keep any 4DOS startup or exit files (4DOS.INI, 4START,
  299.             or 4EXIT) in your 4DOS directory, be sure to move or copy the
  300.             old files into the directory where 4DOS 5.0 is stored.  (If the
  301.             files are in the root directory of the boot drive they do not
  302.             need to be moved.)  Also be sure to modify any path information
  303.             in these files to reflect the new directory for 4DOS (for
  304.             example, if you have a HelpPath directive in 4DOS.INI you may
  305.             need to change it to point to the new directory for the 4DOS
  306.             5.0 copy of the 4HELP program).
  307.  
  308.           * If you use OS/2 2.x, be sure that any DOS_SHELL settings you
  309.             have explicitly set to 4DOS in your DOS session objects are
  310.             modified to reflect the new directory where 4DOS.COM is stored. 
  311.             You can also highlight the DOS_SHELL setting and click on the
  312.             Default button; this will set the command processor for the
  313.             object to whatever is specified on the SHELL= line in
  314.             CONFIG.SYS.  See your 4DOS Introduction and Installation Guide
  315.             for complete details on using 4DOS with OS/2.
  316.  
  317.           * Obtain a copy of the BRAND program which came with your
  318.             registered copy of 4DOS version 4, put it in the same directory
  319.             as the 4DOS version 5 files, and run it with the command BRAND. 
  320.             (If you have the version 4.01 or 4.02 BRAND program you must
  321.             run BRAND5 instead; see above for details.)  Follow the on-
  322.             screen instructions to install your name and serial number into
  323.             4DOS.  The information needed to BRAND your copy is on the
  324.             small blue or yellow "Brand ID Card" which came with your copy
  325.             of 4DOS.  If you cannot find this card with your branding
  326.             codes, you can order a replacement from JP Software for $5.
  327.  
  328.       Once you've made these changes, you can reboot your system and you'll
  329.       be running 4DOS 5.0.
  330.  
  331.  
  332.    Technical Support
  333.  
  334.       We support 4DOS in our own CompuServe area, section 10 of the PC
  335.       Vendor B forum (GO PCVENB).  If you are not currently a CompuServe
  336.       subscriber, consider a special offer CompuServe has made to 4DOS
  337.       users:  call 1-800-848-8199 (outside the US and Canada call 614-457-
  338.       0802) and ask for operator 178 to receive a free CompuServe
  339.       introductory membership, including user ID, password, and a $15
  340.       connect time credit.
  341.  
  342.       For technical support on the Internet send mail to
  343.       75300.1215@compuserve.com.
  344.  
  345.  
  346.  
  347.    4DOS 5.0  [11-23-93]           README.DOC                         page 6
  348.  
  349.  
  350.       Support is also available by phone (617-646-3975), fax (617-646-
  351.       0904), and mail (JP Software, PO Box 1470, E. Arlington, MA 02174). 
  352.       Telephone support hours and availability may vary depending on our
  353.       current staffing pattern and workload; there may not always be a
  354.       support representative available when you call, in which case we will
  355.       take a message and call you back.  We return calls as soon as
  356.       possible, and our normal policy is to return all calls within at most
  357.       24 hours (weekends and holidays excluded).
  358.  
  359.  
  360.    Bulletin Board Support for 4DOS
  361.  
  362.       4DOS product support is always available on our support BBS, Channel
  363.       1 in Boston.  Channel 1 is an independent BBS (not operated by JP
  364.       Software) which has generously offered to provide a home for 4DOS BBS
  365.       support.  Phone 617-354-5776 to access Channel 1 at 2400 - 14,400
  366.       baud (no parity, 8 data bits, 1 stop bit).
  367.  
  368.       If you have access to a local bulletin board which is a member of any
  369.       of the major BBS networks (RIME / PC Relay, ILink, SmartNet, or
  370.       FidoNet), you can discuss 4DOS with other users, and obtain limited
  371.       support from JP Software, by leaving messages in the network's 4DOS
  372.       conference.
  373.  
  374.  
  375.    Shareware Copies of 4DOS
  376.  
  377.       If you obtained 4DOS from a shareware disk vendor, an on-line
  378.       computer service or bulletin board, a friend or colleague, or another
  379.       similar source, you have an unregistered (trial) copy.  As the
  380.       copyright holder for this software, JP Software allows and encourages
  381.       you to use this trial copy without charge for a limited period of
  382.       time, under the terms of our license agreement (see LICENSE.DOC). 
  383.       After this time is up, you must purchase (register and pay for) the
  384.       product to continue using it.
  385.  
  386.       This method of distribution is known as shareware.  It allows you to
  387.       determine whether the product meets your needs before you pay for it.
  388.  
  389.       Payment of the shareware registration fee for 4DOS entitles you to a
  390.       complete copy of the product with typeset-quality printed and bound
  391.       manuals; the ability to download an upgrade to the next major release
  392.       of the product; continued technical support via electronic mail or
  393.       telephone; and a subscription to "The Prompt Solution", JP Software's
  394.       customer newsletter.
  395.  
  396.  
  397.    Association of Shareware Professionals
  398.  
  399.       The authors and publisher of 4DOS are members of the Association of
  400.       Shareware Professionals (ASP), an organization formed to strengthen
  401.       the future of shareware.  Its members, all of whom are programmers
  402.  
  403.  
  404.  
  405.    4DOS 5.0  [11-23-93]           README.DOC                         page 7
  406.  
  407.  
  408.       who subscribe to a code of ethics, are committed to the concept of
  409.       shareware as a method of marketing.
  410.  
  411.       The ASP sets standards for its members and their shareware products
  412.       which provide that programs produced by ASP members must be fully
  413.       documented, non-crippled, and offered with at least a minimum level
  414.       of support.  It also sets standards for shareware disk vendors and
  415.       provides information to the public about shareware.
  416.  
  417.  
  418.    ASP Ombudsman Statement
  419.  
  420.       JP Software is a member of the Association of Shareware Professionals
  421.       (ASP).  ASP wants to make sure that the shareware principle works for
  422.       you. If you are unable to resolve a shareware-related problem with an
  423.       ASP member by contacting the member directly, ASP may be able to
  424.       help. The ASP Ombudsman can help you resolve a dispute or problem
  425.       with an ASP member, but does not provide technical support for
  426.       members' products.  Please write to the ASP Ombudsman at 545 Grover
  427.       Road, Muskegon, MI 49442 or send a CompuServe message via CompuServe
  428.       Mail to ASP Ombudsman 70007,3536.
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.    4DOS 5.0  [11-23-93]           README.DOC                         page 8
  464.  
  465.